home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_amanda.idb / usr / freeware / catman / a_man / cat8 / amadmin.Z / amadmin
Encoding:
Text File  |  1999-07-16  |  10.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV            AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       amadmin - administrative interface to    control    Amanda backups
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       aaaammmmaaaaddddmmmmiiiinnnn _c_o_n_f_i_g _c_o_m_m_a_n_d [ _c_o_m_m_a_n_d _o_p_t_i_o_n_s ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       AAAAmmmmaaaaddddmmmmiiiinnnn performs various administrative tasks    on the _c_o_n_f_i_g
  16.       Amanda configuration.
  17.  
  18.       See the _a_m_a_n_d_a(8) man    page for more details about Amanda.
  19.  
  20.      CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  21.       All commands that take _h_o_s_t_n_a_m_e [ _d_i_s_k_s ] parameters operate
  22.       on all the disks in the _d_i_s_k_l_i_s_t for that _h_o_s_t_n_a_m_e if    no
  23.       disks    are specified.
  24.  
  25.       _D_i_s_k_s    are regular expressions, so "sd0" will match disks
  26.       "sd0a" and "sd0g" and    "/mnt" will match "/mnt", "/mnt/a",
  27.       and "/mnt/b".     To match only "/mnt", use "^/mnt$".  This is
  28.       the same mechanism used by _a_m_r_e_s_t_o_r_e(_8).
  29.  
  30.       vvvveeeerrrrssssiiiioooonnnn
  31.            Show the    current    version    and some compile time and
  32.            runtime parameters.
  33.  
  34.       ffffoooorrrrcccceeee    _h_o_s_t_n_a_m_e [ _d_i_s_k_s ]
  35.            Force the _d_i_s_k_s on _h_o_s_t_n_a_m_e to do a full    level 0    backup
  36.            during the next Amanda run.
  37.  
  38.       uuuunnnnffffoooorrrrcccceeee _h_o_s_t_n_a_m_e [ _d_i_s_k_s ]
  39.            Undo a previous ffffoooorrrrcccceeee command.
  40.  
  41.       rrrreeeeuuuusssseeee    [ _t_a_p_e_l_a_b_e_l ]
  42.            The tapes _t_a_p_e_l_a_b_e_l will    be reuse in the    cycle.
  43.  
  44.       nnnnoooo----rrrreeeeuuuusssseeee [ _t_a_p_e_l_a_b_e_l ]
  45.            The tapes _t_a_p_e_l_a_b_e_l will    never be reuse in the cycle.
  46.  
  47.       ffffiiiinnnndddd [ --------ssssoooorrrrtttt    hhhhkkkkddddllllbbbb ]    _h_o_s_t_n_a_m_e [ _d_i_s_k_s ]
  48.            Display all backups currently on    tape for each disk.
  49.            The tape    label, file number, and    status are displayed.
  50.  
  51.            The --------ssssoooorrrrtttt option changes the sort order    using the
  52.            following flags:
  53.  
  54.            hhhh    host name
  55.            kkkk    disk name
  56.            dddd    dump date
  57.            llll    backup level
  58.            bbbb    tape label
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 5/20/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV            AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))
  71.  
  72.  
  73.  
  74.            An uppercase letter reverses the    sort order for that
  75.            key.  The default sort order is hhhhkkkkddddllllbbbb.
  76.  
  77.       ddddeeeelllleeeetttteeee _h_o_s_t_n_a_m_e _d_i_s_k_s
  78.            Delete the specified _d_i_s_k_s from the Amanda database.
  79.  
  80.            Note: if    you do not also    remove the disk    from the
  81.            _d_i_s_k_l_i_s_t    file, Amanda will treat    it as a    new disk on
  82.            the next    run.
  83.  
  84.       ttttaaaappppeeee Display the label of the    tape Amanda is expecting to
  85.            write to    next.  See also    _a_m_c_h_e_c_k(8).
  86.  
  87.       bbbbuuuummmmppppssssiiiizzzzeeee
  88.            Display the current bump    threshold parameters,
  89.            calculated for all backup levels.
  90.  
  91.       bbbbaaaallllaaaannnncccceeee
  92.            Display the distribution    of full    backups    throughout the
  93.            dump schedule.
  94.  
  95.       eeeexxxxppppoooorrrrtttt [ _h_o_s_t_n_a_m_e [ _d_i_s_k_s ] ]
  96.            Convert records from the    Amanda database    to a text
  97.            format that may be transmitted to another Amanda
  98.            machine and iiiimmmmppppoooorrrrtttted.
  99.  
  100.       iiiimmmmppppoooorrrrtttt
  101.            Convert eeeexxxxppppoooorrrrtttted    records    read from standard input to a
  102.            form Amanda uses    and insert them    into the database on
  103.            this machine.
  104.  
  105.       ddddiiiisssskkkklllliiiisssstttt [ _h_o_s_t_n_a_m_e [    _d_i_s_k_s ]    ]
  106.            Display the _d_i_s_k_l_i_s_t information    for each of the    _d_i_s_k_s
  107.            on _h_o_s_t_n_a_m_e (or all hosts).  Mostly used    for debugging.
  108.  
  109.       iiiinnnnffffoooo [ hostname [ disks
  110.            Display the database record for each of the _d_i_s_k_s on
  111.            _h_o_s_t_n_a_m_e    (or all    hosts).     Mostly    used for debugging.
  112.  
  113.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  114.       Request three    specific file systems on _m_a_c_h_i_n_e-_a get a full
  115.       level    0 backup during    the next Amanda    run.
  116.  
  117.       Note the use of "^/$"    to get the root    file system.  Without
  118.       the extra regular expression characters, just    "/" would have
  119.       matched all the file systems on _m_a_c_h_i_n_e-_a.
  120.  
  121.            $ amadmin DailySet1 force machine-a "^/$" /var /usr
  122.            amadmin:    machine-a:/ is set to a    forced level 0 tonight.
  123.            amadmin:    machine-a:/var is set to a forced level    0 tonight.
  124.            amadmin:    machine-a:/usr is set to a forced level    0 tonight.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 5/20/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV            AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))
  137.  
  138.  
  139.  
  140.       Request all file systems on _m_a_c_h_i_n_e-_b    get a full level 0
  141.       backup during    the next Amanda    run.
  142.  
  143.            $ amadmin DailySet1 force machine-b
  144.            amadmin:    machine-b:/ is set to a    forced level 0 tonight.
  145.            amadmin:    machine-b:/var is set to a forced level    0 tonight.
  146.            amadmin:    machine-b:/usr is set to a forced level    0 tonight.
  147.            amadmin:    machine-b:/home    is set to a forced level 0 tonight.
  148.  
  149.       Undo the previous ffffoooorrrrcccceeee request for /_h_o_m_e on _m_a_c_h_i_n_e-_b.  The
  150.       other    file systems will still    get a full level 0 backup.
  151.  
  152.            $ amadmin DailySet1 unforce machine-b /home
  153.            amadmin:    force command for machine-b:/home cleared.
  154.  
  155.       Locate tapes holding /_v_a_r from _m_a_c_h_i_n_e-_c.  The _f_i_l_e column
  156.       tells    you which file on the tape has the backup (file    number
  157.       zero is a tape label).  The _s_t_a_t_u_s column tells you whether
  158.       the backup was successful or had some    type of    error.
  159.  
  160.            $ amadmin DailySet1 find    machine-c /var
  161.            date       host         disk lv tape    file status
  162.            1997-11-09  machine-c /var  0 000110    9 OK
  163.            1997-11-08  machine-c /var  2 000109    2 OK
  164.            1997-11-07  machine-c /var  2 000108    2 OK
  165.            1997-11-06  machine-c /var  2 000107    2 OK
  166.            1997-11-05  machine-c /var  2 000106    3 OK
  167.            1997-11-04  machine-c /var  2 000105    2 OK
  168.            1997-11-03  machine-c /var  2 000104    2 OK
  169.            1997-11-02  machine-c /var  2 000103    2 OK
  170.            1997-11-01  machine-c /var  1 000102    5 OK
  171.            1997-10-31  machine-c /var  1 000101    3 OK
  172.  
  173.       Forget about the /_w_o_r_k_s_p_a_c_e disk on _m_a_c_h_i_n_e-_d.  If you do
  174.       not also remove the disk from    the _d_i_s_k_l_i_s_t file, Amanda will
  175.       treat    it as a    new disk on the    next run.
  176.  
  177.            $ amadmin DailySet1 delete machine-d /workspace
  178.            amadmin:    machine-d:/workspace deleted from database.
  179.            amadmin:    NOTE: you'll have to remove these from the disklist yourself.
  180.  
  181.       Find the next    tape Amanda will use (in this case, _1_2_3_4_5_6).
  182.  
  183.            $ amadmin DailySet1 tape
  184.            The next    Amanda run should go onto tape 123456 or a new tape.
  185.  
  186.       Show how well    full backups are balanced across the dump
  187.       cycle.  The _d_u_e-_d_a_t_e column is the day the backups are due
  188.       for a    full backup.  #_f_s shows    the number of filesystems
  189.       doing    full backups that night, and _o_r_i_g _K_B and _o_u_t _K_B    show
  190.       the estimated    total size of the backups before and after any
  191.       compression, respectively.
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 5/20/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV            AAAAMMMMAAAADDDDMMMMIIIINNNN((((8888))))
  203.  
  204.  
  205.  
  206.       The _b_a_l_a_n_c_e column shows how far off that night's backups
  207.       are from the average size (shown at the bottom of the
  208.       balance column).  Amanda tries to keep the backups within
  209.       +/- 5%, but since the    amount of data on each filesystem is
  210.       always changing, and Amanda will never delay backups just to
  211.       rebalance the    schedule, it is    common for the schedule    to
  212.       fluctuate by larger percentages.  In particular, in the case
  213.       of a tape or backup failure, a bump will occur the following
  214.       night, which will not    be smoothed out    until the next pass
  215.       through the schedule.
  216.  
  217.       The last line    also shows an estimate of how many Amanda runs
  218.       will be made between full backups for    a file system.    In the
  219.       example, a file system will probably have a full backup done
  220.       every    eight times Amanda is run (e.g.    every eight days).
  221.  
  222.            $ amadmin DailySet1 balance
  223.         due-date  #fs    orig KB       out KB  balance
  224.            -------------------------------------------
  225.            11/10 Mon   21     930389       768753    +5.1%
  226.            11/11 Tue   29    1236272       733211    +0.2%
  227.            11/12 Wed   31    1552381       735796    +0.6%
  228.            11/13 Thu   23    1368447       684552    -6.4%
  229.            11/14 Fri   32    1065603       758155    +3.6%
  230.            11/15 Sat   14    1300535       738430    +0.9%
  231.            11/16 Sun   31    1362696       740365    +1.2%
  232.            11/17 Mon   30    1427936       773397    +5.7%
  233.            11/18 Tue   11    1059191       721786    -1.3%
  234.            11/19 Wed   19    1108737       661867    -9.5%
  235.            -------------------------------------------
  236.            TOTAL      241  12412187      7316312   731631  (estimated 8 runs per dumpcycle)
  237.  
  238.      FFFFIIIILLLLEEEESSSS
  239.       /usr/freeware/etc/amanda/_c_o_n_f_i_g/amanda.conf
  240.  
  241.      AAAAUUUUTTTTHHHHOOOORRRR
  242.       James    da Silva <jds@cs.umd.edu>
  243.       University of    Maryland, College Park
  244.  
  245.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  246.       amanda(8), amcheck(8), amdump(8), amrestore(8)
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 5/20/99)
  262.  
  263.  
  264.  
  265.